←Select platform

SetRowCompressed(byte[],ushort[],int,int,int) Method

Summary
Puts one or more rows of 1-bit compressed data from a buffer into an image that is maintained in its compressed format.
Syntax
C#
Objective-C
C++/CLI
Java
Python
[CLSCompliantAttribute(false)] 
public void SetRowCompressed( 
   byte[] workBuffer, 
   ushort[] runBuffer, 
   int runBufferOffset, 
   int row, 
   int lines 
) 
- (BOOL)setRowCompressed:(unsigned char *)workBuffer  
               runBuffer:(const unsigned short *)runBuffer  
                     row:(NSUInteger)row  
                   lines:(NSUInteger)lines  
                   error:(NSError **)error 
public void setRowCompressed( 
  byte[] workBuffer,  
  short[] runBuffer,  
  int runBufferOffset,  
  int row,  
  int lines 
) 
[CLSCompliantAttribute(false)] 
public: 
void SetRowCompressed(  
   array<byte>^ workBuffer, 
   array<ushort>^ runBuffer, 
   int runBufferOffset, 
   int row, 
   int lines 
)  
def SetRowCompressed(self,workBuffer,runBuffer,runBufferOffset,row,lines): 

Parameters

workBuffer
Optional work buffer. Allocating the work buffer speeds processing if you call this method more than once, because if you do not allocate a work buffer, the method allocates and frees a temporary buffer each time it is called. The size of this buffer should be the same as the image's BytesPerLine property. Pass a null reference to  runBuffer if you do not want to use a work buffer.

runBuffer
Input buffer, which contains 1-bit compressed image data.

runBufferOffset
Offset into  runBuffer where the set operation should start.

row
Number of the first row to update.

lines
Number of rows to update.

Remarks

This method is available in the (Document/Medical only) Toolkits.

This method is useful for working with 1-bit images that are loaded in their compressed formats for faster loading and display.

For more information, refer to Speeding Up 1-Bit Documents.

Example
C#
using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.ImageProcessing; 
using Leadtools.ImageProcessing.Core; 
using Leadtools.ImageProcessing.Color; 
using Leadtools.Dicom; 
using Leadtools.Drawing; 
using Leadtools.Controls; 
using Leadtools.Svg; 
 
 
public void GetRowCompressedExample() 
{ 
	RasterCodecs codecs = new RasterCodecs(); 
	// Load the bitmap, at 1 bit per pixel, compressed 
	codecs.Options.Load.Compressed = true; 
	RasterImage image = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, "OCR1.TIF"), 1, Leadtools.Codecs.CodecsLoadByteOrder.Bgr, 1, 1); 
 
	// This example does not work with rotated view perspectives. 
	if ((image.ViewPerspective != RasterViewPerspective.TopLeft) || (image.ViewPerspective != RasterViewPerspective.BottomLeft)) 
		image.ChangeViewPerspective(RasterViewPerspective.TopLeft); 
 
	// Adjust the YOffset if the view perspective is bottom left. 
	int nRow = 500; // first row to get. 
	int nYSize = 500; // number of rows to get. 
 
	if (image.ViewPerspective == RasterViewPerspective.BottomLeft) 
		nRow = image.Height - nRow - nYSize; 
 
	// Allocate the buffers. 
	byte[] pBuffer = new byte[Convert.ToInt32((((image.Width + 31) & ~(31)) / 8)) * nYSize]; // Buffer to hold the expanded row. 
	ushort[] pRunBuffer = new ushort[((image.Width + 3) * 2) * nYSize]; // Buffer to hold the compressed row. 
 
	if (image.IsGlobalMemory) 
		image.Access(); 
	// Get the top nRow lines. 
	image.GetRowCompressed(null, pRunBuffer, 0, nRow, nYSize); 
	// Expand the compressed data. 
	RasterRleCompressor.ExpandRows(pRunBuffer, pBuffer, 0, image.Width, nYSize); 
	// Invert the data. 
 
	for (int n = 0; n < (image.BytesPerLine * nYSize); n++) 
		pBuffer[n] ^= 0xff; 
 
 
	// Compress the inverted data. 
	RasterRleCompressor.CompressRows(pRunBuffer, pBuffer, 0, image.Width, nYSize); 
 
	// Put the inverted, compressed data back into the image. 
	image.SetRowCompressed(null, pRunBuffer, 0, nRow, nYSize); 
 
	if (image.IsGlobalMemory) 
		image.Release(); 
 
	codecs.Save(image, Path.Combine(LEAD_VARS.ImagesDir, "IMAGE1_getrowcompresed.BMP"), RasterImageFormat.Bmp, 0); 
 
	image.Dispose(); 
	codecs.Dispose(); 
} 
 
static class LEAD_VARS 
{ 
   public const string ImagesDir = @"C:\LEADTOOLS22\Resources\Images"; 
} 
Requirements

Target Platforms

Help Version 22.0.2023.5.16
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.

Leadtools Assembly
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.